home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr15 / ansblk15.zip / ANSIBLK.DOC next >
Text File  |  1993-05-12  |  10KB  |  200 lines
  1.  
  2.  
  3.  
  4.                            ┌─────────╖   ┌─────────╖
  5.                            │         ║   │         ║
  6.                            │         ║   │         ║
  7.                            │      ┌──╫───┼──┐      ║
  8.                            ╘══════╪══╝   ╘══╪══════╝
  9.                                   │         │
  10.                            ┌──────├──╖   ┌──┼──────╖
  11.                            │      └──╫───┼──┘      ║
  12.                            │         ║   │         ║
  13.                            │         ║   │         ║
  14.                            ╘═════════╝   ╘═════════╝
  15.  
  16.                           ANSIBlk, Ver. 1.5, (c) 1993
  17.                         EFD Systems, All Rights Reserved
  18.  
  19.                               304 Smokerise Circle
  20.                                Marietta, GA 30067
  21.                              CompuServe: 72627,3026
  22.  
  23.  
  24.  
  25. ───────────────────────────────────────────────────────────────────────────────
  26.                                   DESCRIPTION
  27.  
  28. ANSIBlk (short for ANSI BLOCK) is a rudimentary program for producing colorized
  29. ASCII character display screens, commonly referred to as ANSI graphics.  ANSIBlk
  30. was primarily designed for programming applications; however, other uses are
  31. possible.  ANSIBlk works equally well with either full or partial screen
  32. displays. All data is stored and manipulated as a binary text-mode memory image
  33. (character byte followed by attribute byte) with a 2 byte header (block width
  34. and height) added to facilitate re-loading partial screen images.  The DOS
  35. ANSI.SYS screen driver is not required and the ASCII ESC code sequences used by
  36. this driver are not supported.  Obviously, a color monitor is needed; otherwise,
  37. there is no reason to use ANSIBlk.  The included DSPLYBLK utility can display
  38. images from the command line and from batch files at any given screen location.
  39.  
  40. This is not the only ANSI graphics software available.  Others provide similiar
  41. or even much more extensive capabilities; however, the available ones were all
  42. unacceptable to me for one reason or another.  Many will not work well with
  43. partial screen images.  Some will save a partial screen block but do not store
  44. any image size information with the data making it difficult to re-display the
  45. image later from a user written program.  Others are simply too complex, in my
  46. opinion, for simple, occasional use.  Hence, ANSIBlk was born.
  47.  
  48.  
  49. ───────────────────────────────────────────────────────────────────────────────
  50.                              USING ANSIBlk
  51.  
  52. To use ANSIBlk type:  ANSIBlk [filename] [options]
  53.  
  54.            filename:  A valid DOS file name.  A .BIN extension is assumed unless
  55.                       otherwise specified.  The file is created if it does not
  56.                       exist.  Files can be loaded, saved and renamed from inside
  57.                       ANSIBlk.
  58.  
  59.             options:  /A  - import ASCII characters from "filename".  Only the
  60.                             first 80 columns of each line are imported.
  61.                       /30 - 30 lines per screen, VGA graphics mode
  62.                       /43 - 43 lines per screen, EGA text mode
  63.                       /50 - 50 lines per screen, VGA text mode
  64.                       /60 - 60 lines per screen, VGA graphics mode
  65.  
  66. Default mode is 25 lines per screen, binary data format.
  67.  
  68. ANSIBlk works in VGA graphics modes using the same character/attribute data
  69. format as for the text modes.  The ASCII character portion of a graphics mode
  70. screen can be created and stored very efficiently in this way while allowing for
  71. bit-mapped graphics to be added later.  The user's program must interpret and
  72. load the ANSIBlk data onto the graphics mode bit-planes.
  73.  
  74. ANSIBlk provides rudimentary editing capability.  Existing on-screen characters
  75. can be either painted (colorized) with selected foreground and background colors
  76. or erased with the DELETE key or overwritten by typing new characters.  A full
  77. set of block functions (PAINT, CUT, COPY, and PASTE) are provided for working
  78. with rectangular screen regions.  A convenient box drawing mode and a
  79. point-and-shoot ASCII character chart are also provided.  If more extensive
  80. editing capability is required, you should consider creating the screen using an
  81. ASCII editor and then import the ASCII screen into ANSIBlk for colorization.
  82.  
  83. All input from the keyboard is interpreted literally for screen display.  For
  84. example, pressing ENTER simply displays an ASCII character 13 at the current
  85. cursor location in the currently selected colors.
  86.  
  87. The bottom line of the screen is used as a menu/dialog area.  A function key
  88. menu is displayed on the bottom line at startup by default.  ALT-F1 toggles this
  89. menu ON/OFF, thus allowing the bottom line to be used for drawing and creating
  90. full screen images.  Image data entered on the bottom line remains stored in
  91. memory even if the menu is later toggled back on.
  92.  
  93. ───────────────────────────────────────────────────────────────────────────────
  94.                                     PAINTING
  95.  
  96. The color of existing screen characters can be altered by "painting" with a
  97. virtual pen or brush.  Painting is a 3 step process:
  98.  
  99. 1) select the desired foreground and background colors using F2 then;
  100. 2) place the pen in the DOWN position using Page Down and;
  101. 3) move the cursor using the Arrow keys to change foreground and background of
  102.    on-screen characters to the current color settings.
  103.  
  104. Page Up and Page Down are used to control the Pen position.  Pen DOWN is
  105. indicated by an asterisk cursor.  With the Pen UP, the arrows keys simply move
  106. the cursor without painting.
  107.  
  108. Block operations (see below) allow entire rectangular regions to be painted in
  109. one easy step.
  110.  
  111. Keyboard input is displayed on-screen in the currently selected colors without
  112. regard to the Pen position.
  113.  
  114. ───────────────────────────────────────────────────────────────────────────────
  115.                                   BOX DRAWING
  116.  
  117. F4 toggles ASCII box drawing mode ON/OFF and allows the user to select one of
  118. five different box drawing modes.  The available modes are:
  119.  
  120.    ┌────────┐   ╔════════╗   ╒════════════╕  ╓─────────────╖         ──┐
  121.    │ SINGLE │   ║ DOUBLE ║   │ DOUBLE TOP │  ║ DOUBLE SIDE ║  │ ERASER │
  122.    └────────┘   ╚════════╝   ╘════════════╛  ╙─────────────╜  └────────┘
  123.  
  124. With box mode ON, lines, corners and intersections are all created on-the-fly by
  125. simply moving the cursor.
  126.  
  127. ───────────────────────────────────────────────────────────────────────────────
  128.                                 BLOCK OPERATIONS
  129.  
  130. F3 selects the block function sub-menu.  Available block functions are PAINT,
  131. CUT, COPY and PASTE.  After selecting a function, the user is prompted to
  132. indicate the rectangular screen block to be operated on by moving the cursor
  133. first to the upper-left corner of the block and then to the lower-right corner
  134. of the block.  ESC cancels any block operation in progress.
  135.  
  136. The Pen position has no affect on block operations.
  137.  
  138. SAVE is also a block function, although it is not part of the block sub-menu.
  139. The same block marking procedure described above is used to define the screen
  140. area to be saved.
  141.  
  142. ───────────────────────────────────────────────────────────────────────────────
  143.                                 FILE OPERATIONS
  144.  
  145. Files can be loaded and saved using F9.  Any number of disk file images can be
  146. overlayed on the screen.  Images are loaded from disk and positioned with the
  147. upper left corner of the image at the current cursor location.  Data that falls
  148. off the screen is ignored.
  149.  
  150. When saving, the user is always prompted to indicate the upper left and the
  151. lower right of the screen block to be saved.  To include the bottom line of the
  152. screen in the save block, the function key menu must be turned off (ALT-F1)
  153. before the save is started.
  154.  
  155. ───────────────────────────────────────────────────────────────────────────────
  156.                                      MISC.
  157.  
  158. INSERT re-enters the "last character" as if it were typed from the keyboard. The
  159. "last character" is either the character that was last typed from the keyboard
  160. or the character that was selected from the point-and-shoot ASCII chart using
  161. F1.  With menu ON, the "last character" is shown at the start of the function
  162. key menu line.
  163.  
  164. ALT-X sets "last character" as the character at the current cursor location.
  165.  
  166. ALT-C sets foreground and background colors to match the character at the
  167. current cursor location.
  168.  
  169. HOME/END move the cursor to the Start/End of the current line.
  170.  
  171. CTRL-HOME/CTRL-END move the cursor to the extreme upper left/lower right of the
  172. active screen.
  173.  
  174. The included command line screen display utility, DSPLYBLK.EXE, leaves the
  175. screen in whatever mode was selected for the screen display.  To restore the
  176. screen to normal 80 column text mode type "MODE 80 [ENTER]" at the DOS prompt.
  177.  
  178. ───────────────────────────────────────────────────────────────────────────────
  179.                         LICENSE AGREEMENT and DISCLAIMER
  180.  
  181. This software and the included documentation is provided solely "as is".  The
  182. author hereby disclaims any and all warranties, either expressed or implied,
  183. including without limitation the warranties of merchantability and fitness of
  184. purpose.  In no event will the author be liable for any damages, incidential,
  185. consequential or otherwise, resulting from the use or mis-use of this software.
  186. In any event, the author's liability shall be limited to the originial software
  187. license purchase price.
  188.  
  189. ANSIBlk ver. 1.5 is provided for private personal use without payment of a
  190. license fee; however, it is not public domain software.  Legal ownership and all
  191. other legals rights pertaining to the software are reserved and retained by the
  192. author.  Later versions of the software may or may not enjoy similiar status.
  193. The software may be freely distributed provided that no fee of any kind is
  194. charged in connection with such distribution.  The only exception is electronic
  195. phone service connection fees.  This software may not be distributed in
  196. connection with or incorporated into any software or other product being
  197. distributed, demonstrated, sold or offered for sale without the expressed
  198. written permission of the author.  Anyone wishing to obtain such permission may
  199. contact the author at the address listed at the front of this documentation.
  200.